home *** CD-ROM | disk | FTP | other *** search
/ The Mac Mega CD - Killer Software / The Mac Mega CD - Killer Software (May 1996).dmg / Shareware City / Comms. & Networking / WebStat 2.3.4DB / READ ME next >
Encoding:
Text File  |  1996-01-09  |  6.0 KB  |  150 lines  |  [TEXT/ttxt]

  1. ==================================================================================
  2.  
  3.      WebStat 2.3.4DB - A program to summarize WinHTTP transmission statistics
  4.      from
  5.      WebStat - A program to summarize MacHTTP transmission statistics
  6.  
  7.      by Phil Harvey    (phil@nsun.phy.queensu.ca)
  8.      Physics Dept.
  9.      Queen's University
  10.      Kingston, Ontario
  11.      K7L 3N6
  12.  
  13.      2.3.4DB version by Denis Birnie (D.Birnie@Regy.Canterbury.ac.NZ)
  14.      Information Services Section,
  15.      University of Canterbury,
  16.      Christchurch, New Zealand.
  17. ----------------------------------------------------------------------------------
  18. Why a Mac application to process a PC WWW server's log file???
  19. Well, our site is essentially all PC and our WWW server <http://WWW.Regy.Canterbury.ac.NZ/> is a spare 386. I however had the site's one Mac on my desk, a personal copy of CodeWarrior, no compiler for Windows and didn't really want to risk development & processing on the server - the rest, as they say, is history... (DEN, 9 Jan 96)
  20. ----------------------------------------------------------------------------------
  21.  
  22. To run the program:
  23.  
  24.      1) Drag the WebStat, WebStat.config, and WebStat.format icons into your MacHTTP folder.
  25.          or
  26.          Copy/Drag the log file (named "MacHttp.log") to your WebStat folder. 
  27.  
  28.      2) Double click on the WebStat icon.
  29.  
  30. The WebStat program will read your MACHTTP.LOG file and produce a summary file called WebStat.html in your MacHTTP folder.  The output format is specified by the WebStat.format file.
  31.  
  32. The configuration file is used to set the following parameters:
  33.  
  34.     LOG - input log file name
  35.     OUTPUT - output summary file name
  36.     FORMAT - file specifying output format
  37.     EXCLUDE - host names to exclude from summary
  38.     MESSAGES - turn message output on or off
  39.     ADDRESSES - specify long or short version of host name addresses
  40.     DOMAIN - specify name for domain codes
  41.     DNSLOOKUP - look up numerical addresses using domain name server
  42.  
  43. Read WebStat.config for more details about configuration.
  44.  
  45. The program is provided as is.  The source code can be modified or included in other projects provided due credit is given to the author, Phil Harvey.
  46.  
  47. The included binary file was generated using CodeWarrior 6.
  48.  
  49. Notes:  
  50.  
  51.      1) Previous to MacHTTP 1.2.5 the number of bytes sent was not reported, so you can expect to see zero's in the number of bytes transferred fields for older log files.
  52.  
  53.      2) If you want to check your server statistics from a remote computer by downloading your log file using Mosaic, you must add the line "TEXT .LOG TEXT ttxt text/plain" to your MacHTTP server configuration file.  Otherwise the text will be reformatted and WebStat won't run properly.
  54.  
  55.      3) If you want to run WebStat automatically at preset times, use the Cron utility by Mark Malson.  You can get a copy from any Info-Mac mirror, or download it from me at "http://snodaq.phy.queensu.ca/Cron.sit.Hqx".  If you use this utility, make sure MESSAGES is "Off" in the WebStat.config file or WebStat won't terminate automatically.
  56.  
  57.      4) If you have any problems running WebStat, turn "MESSAGES On" in the config file and try running it again.  The printed messages may help you to locate the problem.
  58.  
  59. ----------------------------------------------------------------------------------
  60.  
  61. Revision history:
  62.  
  63. 01/10/96 - V 2.3.4DB
  64. - Statistics are now generated for "visits".
  65.    A visit is defined as "a cluster of files being sent to a particular IP# followed
  66.    by a period of time (default is 30 minutes) in which no files are sent to that IP#."
  67.    Note that an unlimited number of visits can occur simultaneously and
  68.    that there is no time limit on the length of visits.
  69. - The program has been altered to process WinHttp log files,
  70.    though the original MacHttp (now WebSite?) log file reading code is still there!
  71. - The program has been converted to CodeWarrior 6, 
  72.    though the original ThinkC project file is still included with this distribution.
  73. - this version was released by Denis Birnie.
  74. - Many Thanks to Phil Harvey for his original great program!
  75.  
  76. 10/11/94 - V 2.3.4
  77. - progress bar now displays properly on B&W screens
  78.  
  79. 10/03/94 - V 2.3.3
  80. - fixed problem which could cause crash if stop button pressed
  81. - message dialog box is now properly activated
  82.  
  83. 10/02/94 - V 2.3.2
  84. - changed progress indicator; added stop button
  85. - re-fixed small bug in DNS lookups lost in 2.3.1
  86.  
  87. 09/28/94 - V 2.3.1
  88. - fixed problem in event handling during DNS lookups
  89. - fixed problem with output going to system folder broken in 2.3
  90.  
  91. 09/28/94 - V 2.3
  92. - added progress indicator if MESSAGES Off
  93. - allows background processing if MESSAGES Off
  94. - fixed small bug in DNS lookups
  95. - Cmd-. aborts processing if MESSAGES Off
  96. - MESSAGES Off is now the default
  97.  
  98. 09/27/94 - V 2.2
  99. - added DNSLOOKUP option
  100.  
  101. 08/11/94 - V 2.1
  102. - removed limit on number of EXCLUDE and DOMAIN statements
  103. - sort numerical addresses properly
  104.  
  105. 06/06/94 - V 2.0
  106. - truncate filenames at '$' because of new cgi formatting
  107. - added check on time_t values passed to GetNumDays()
  108. - added format file (replaces SUMMARIZE option of V1.9)
  109.  
  110. 05/13/94 - V 1.9
  111. - added SUMMARIZE options; changed to Symantec C++ 7.0
  112. - fixed quirk where days with no transfers were ignored
  113.  
  114. 04/14/94 - V 1.8
  115. - ignored improperly formatted lines in log file
  116.  
  117. 04/11/94 - V 1.7.1
  118. - delete trailing '/' if found in file names
  119.  
  120. 04/08/94 - V 1.7
  121. - added comprehensive list of Domain names to config file
  122. - changed spacing to accomodate longer domain names
  123.  
  124. 04/04/94 - V 1.6
  125. - added ADDRESSES Long/Short option
  126. - changed MESSAGES syntax from True/False to On/Off
  127. - added DOMAIN command to config file
  128.  
  129. 03/31/94 - V 1.5 
  130. - added config file and moved exclusions into config
  131.  
  132. 03/30/94 - V 1.4
  133. - changed subdomain list to not reverse numerical entries
  134. - placed numerical entries at end of list
  135.  
  136. 03/29/94 - V 1.3
  137. - added exclusion option and application icon
  138. - changed all byte counts from long to double
  139.  
  140. 03/28/94 - V 1.2
  141. - added anchors for lists; converted code to C++
  142.  
  143. 03/25/94 - V 1.1
  144. - fixed array indexing problem
  145.  
  146. 03/24/94 - V 1.0 
  147. - original
  148.  
  149. ==================================================================================
  150.